home *** CD-ROM | disk | FTP | other *** search
/ Scene 96 / Scene 96 International Edition (Zyklop Software) (Disc 1) (1997).iso / emulator / amiga065 / docs / qsetup.dos < prev    next >
Text File  |  1996-12-20  |  11KB  |  241 lines
  1. ******************************************************************************
  2. *                 UAE - THE UN*X AMIGA EMULATOR Version 0.6.5                *
  3. *                           Written by Bernd Scmidt                          *
  4. *           DOS port by Gustavo Goedert, Peter Remmers and Tim Gunn          *
  5. *                         Documentation by Brett Eden                        *
  6. *                                                                            *
  7. *                       Q U I C K  S E T U P  G U I D E                      *              *
  8. *                       ---------  ---------  ---------                      *              *
  9. ******************************************************************************
  10.  
  11. [FOREWORD]
  12.  
  13. This document has been produced to help the beginner install, configure and
  14. run UAE quickly and easily.  Some people have experienced difficulties in
  15. getting UAE set up properly so I have decided to put together this guide to
  16. help those folks out.
  17.  
  18.                                                         Brett Eden
  19.  
  20. <STEP ONE>
  21.  
  22. From a MS-DOS Shell, create a new directory somewhere on your hard-disk.
  23. This is where you'll be installing UAE, so give it a logical name like UAE
  24. or UAE604, or whatever the version number might be.  This is done using the
  25. mkdir command:
  26.  
  27. mkdir UAE <ENTER>
  28.  
  29. <STEP TWO>
  30.  
  31. Copy the .zip files containing the UAE distribution into the UAE directory.
  32. Take for example you downloaded them into a directory called DOWNLOAD, and
  33. we wanted to copy them into the UAE directory.
  34.  
  35. This is done using the copy command:
  36.  
  37. copy C:\DOWNLOAD\DUAE*.zip C:\UAE
  38.  
  39. <STEP THREE>
  40.  
  41. Unzip the DOS UAE distribution archives, using PKUNZIP or your favourite
  42. zip handling utility:
  43.  
  44. pkunzip DUAE*.zip
  45.  
  46. <STEP FOUR>
  47.  
  48. You should now have a directory full of files, as well as a couple of
  49. sub-directories.
  50.  
  51. <STEP FIVE>
  52.  
  53. Before we can launch UAE, we're going to need some software to run on it,
  54. aswell as a Kickstart ROM image so that we can use the Workbench operating
  55. system.
  56.  
  57. I'm going to use two examples here.  Firstly, I'm going to show you how to
  58. install UAE disk-images that you may have downloaded from the Internet
  59. or obtained from somewhere else.  Secondly, I'll demonstrate how to obtain
  60. disk-image files from a real Amiga computer.
  61.  
  62. 1. Software you've downloaded or copied from elsewhere.
  63.  
  64. We'll need to copy our new disk-images into the UAE directory, so that we
  65. don't lose them.  Let's assume we either downloaded them to C:\DOWNLOAD
  66. or have them on a 3.5" floppy disk.
  67.  
  68. In the case of having downloaded them:
  69.  
  70. copy C:\DOWNLOAD\GAME.ADF C:\UAE
  71.  
  72. And in the case of our 3.5" floppy disk:
  73.  
  74. copy A:\GAME.ADF C:\UAE
  75.  
  76. You may find that your 3.5" disk drive is B: and not A:, in which case
  77. you'll have to make the appropriate changes to the above command.
  78. GAME.ADF is just an example file name, and you may find that the image
  79. you have obtained may be called something else, in which case you'll have
  80. to make that change in either of the above commands.
  81.  
  82.  
  83. 2. Obtaining disk-images from a real Amiga.
  84.  
  85. In your UAE directory, you will find a subdirectory called AMIGA.  In here
  86. are four utilities: transdis, transrom, uaectrl and uae-cont.  Right now,
  87. we'll only look at two of them, transdis and transrom.
  88.  
  89. Transdis (Actually called Transdisk, but was shortened to meet DOS's 8 letter
  90. file name requirements) and transrom need to be copied over to the real
  91. Amiga so that we can obtain the necessary software to use with UAE.
  92.  
  93. I'm going to make example of two ways which you can copy these files to an
  94. Amiga.
  95.  
  96. a) Floppy disk.
  97.  
  98. Amiga's equipped with CrossDOS software (bundled with versions 2.1 and
  99. later of Workbench) can read 720KB IBM PC disks.  By formatting a 720KB disk
  100. on your PC and copying the transdisk and transrom files to it, you can them
  101. take it over to the Amiga and copy it there, where it can be used.
  102.  
  103. b) Null-modem cable.
  104.  
  105. If you happen to own a null-modem cable, or can borrow one for use, you can
  106. use it to copy files between an Amiga and a PC with the aid of a terminal
  107. package like Telix, Terminate, Telemate or any similar packages like the
  108. ones that are bundled with Windows 3.x and Windows 95.  Initiating a X, Y or
  109. Z modem transfer between the two machines after the cable has been attached
  110. and the terminal packages loaded should enable you the copy the files to
  111. the Amiga.
  112.  
  113. Now that we have our transdisk and transrom files on the Amiga, we can start
  114. making some disk images to use with UAE, aswell as that Kickstart ROM image
  115. we're going to need.  If you're only planning on running games on UAE, you
  116. won't need a Kickstart ROM image unless the games in question has some
  117. components from the Workbench operating system included with it.
  118.  
  119. Open a shell and type the following:
  120.  
  121. transrom >DH0:
  122.  
  123. Will generate the file "kick.rom" on the DH0: harddisk.  Obtaining files
  124. from an Amiga without a hard-disk is next to impossible, so I'm not going
  125. to go into it here.  If you don't have a hard-disk on your Amiga, find
  126. someone who does or obtain your disk images elsewhere.
  127.  
  128. To make a disk image of your favourite game, insert the disk into the DF0:
  129. floppy drive and type the following from a shell:
  130.  
  131. transdisk >DH0:GAME.ADF
  132.  
  133. Will create the file GAME.ADF on DH0:, which is actually a copy of the disk
  134. in DF0: which UAE can use.
  135.  
  136. A full description of the transdisk and transrom commands are in the main
  137. documentation, so consult there if you want to know more about how they work.
  138.  
  139. <STEP SIX>
  140.  
  141. Now that we've created our Kickstart ROM image and our disk image(s), we'll
  142. have to get them over to the PC for UAE to use them.  As I mentioned above,
  143. you can copy files over a null-modem cable using a terminal package.  If
  144. this doesn't sound like the way for you, you can use LhA or ZIP to compress
  145. the images on the Amiga and then copy them to a 720KB disk (using CrossDOS
  146. as mentioned above) where they can be taken back to the PC, and uncompressed
  147. into the UAE directory.  I chose LhA and ZIP because they are two archiving
  148. formats supported on both the Amiga and tha PC.
  149.  
  150. <STEP SEVEN>
  151.  
  152. All being well, you should now have a Kickstart ROM image and one or more
  153. disk images in your UAE directory.  The Kickstart ROM, providing it is named
  154. "kick.rom" will be automatically detected by UAE, so we won't have to do
  155. anything there.
  156.  
  157. We have to inform UAE that we have one or more disk images that we wish to
  158. use.  This is done by selecting "Disk Settings" from the UAE configuration
  159. menu, and DF0: to insert a disk into that drive.  After selecting DF0:,
  160. you will be presented with a file lister, from which you will have to pick
  161. the disk image file that you want to go into DF0:
  162.  
  163. DF0: is the Amiga's boot drive, so if you've transferred a multi-disk game,
  164. you'll want to put the first disk there.  If you have extra disks, allocate
  165. them to subsequent drives, DF1:, DF2:, etc.
  166.  
  167. Read over the main documentation for information on changing disk images
  168. while the emulator is running, in the case of software that has more than
  169. 4 disks.
  170.  
  171. <STEP EIGHT>
  172.  
  173. Now it's time to configure our sound and display settings. If you want sound
  174. while running UAE, make sure your sound card is installed and configured
  175. properly - UAE should detect it when you start up.  Select "Sound Settings"
  176. from the configuration menu and select the "Produce sound" sub-option until
  177. "on - emulated perfectly" appears over in the sound section on the right
  178. side of the screen.
  179.  
  180. How you configure your video settings depends on what kind of machine you
  181. have, and whether or not you're planning on running Workbench during a
  182. particular session.  If you have a low-end pentium system and just plan to
  183. play games, 320x200, 320x240 or 320x400 are fine.  However, if you're going
  184. to run Workbench, you will need to use 640x480 or 800x600 with aspect
  185. correction enabled if you want it to appear correct and proportional.
  186.  
  187. Slower machines should use the lower resolutions, with 256 colours.  Faster
  188. machines running Workbench should use the SVGA modes with either 256 or more
  189. colours.
  190.  
  191. If you find that a game runs too slow on your machine, edit the frame option
  192. in the "Video Settings" menu.  This will make the emulator skip a set number
  193. of frames to speed up the display.
  194.  
  195. <STEP NINE>
  196.  
  197. If you don't have a joystick, you can map the joystick controls to the keypad
  198. on your keyboard, so you can still control games as you would normally with
  199. a joystick. This can be set under the "Other Settings" menu.  Alternatively,
  200. you can use a real Joystick, which UAE should detect when you first run it.
  201.  
  202. <STEP TEN>
  203.  
  204. All things being well and good, you should now be ready to run UAE. Consult
  205. the following check list to make sure you've got everything configured
  206. correctly.
  207.  
  208. ■ Have you launched your mouse driver program before running UAE?  Workbench
  209.   and a lot of games will not function without a mouse.
  210.  
  211. ■ Do you have a disk image assigned to (at the very least) DF0:?
  212.  
  213. ■ If you're going to run Workbench, do you have a Kickstart ROM image
  214.   installed in the UAE directory?  Is it named "kick.rom"?
  215.  
  216. ■ If planning on running UAE in SVGA modes, does your video hardware support
  217.   Vesa BIOS extensions?  If not, the display will not look correct.  Consult
  218.   the main documentation for more information on this, and where to obtain
  219.   a VBE driver.
  220.  
  221. After you're certain you have everything set up properly, launch UAE by
  222. selecting the "Run UAE!" option from the top of the UAE configuration menu.
  223. If, for some reason, it does not work as expected, consult the main
  224. documentation for troubleshooting tips.
  225.  
  226. If you're still having problems after you've read this document, there are
  227. still several avenues where you can find help in getting UAE running.  They
  228. are as follows:
  229.  
  230. ■ The author of the DOS port of UAE has set up a UAE discussion board on
  231.   the World Wide Web, where you can ask general questions about UAE.  You're
  232.   certain to get the answer you want here, because of the number of people
  233.   who participate in the service.
  234.  
  235. ■ If you have access to IRC, you can try the #amiga channel, as there are
  236.   normally people there who have experience with UAE and can help you.
  237.  
  238. ■ The author of this document <beden@eastwind.livewire.com.au> has offered
  239.   his services in answering general UAE queries.  Answers are normally given
  240.   the following day.
  241.